home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / gfx / fig2dev_.lha / fig2dev_fix / fig2dev.txt < prev    next >
Text File  |  1995-08-11  |  17KB  |  410 lines
  1. NAME
  2.        fig2dev  -  translates  Fig  code to various graphics lan-
  3.        guages
  4.  
  5. SYNOPSIS
  6.        fig2dev -L language [ -m mag ] [ -f font ] [ -s fsize ]  [
  7.        other options ] [ fig-file [ out-file ] ]
  8.  
  9. DESCRIPTION
  10.        Fig2dev translates fig code in the named fig-file into the
  11.        specified graphics language and  puts  them  in  out-file.
  12.        The  default  fig-file and out-file are standard input and
  13.        standard output, respectively
  14.  
  15.        Fig (Facility for Interactive Generation of figures) is  a
  16.        screen-oriented  tool  which  allows  the user to draw and
  17.        manipulate objects interactively.  Various versions of Fig
  18.        run  under  the  Suntools/Sunview  window  environment and
  19.        under version 11 of the X Windows System.  Fig2dev is com-
  20.        patible with Fig versions 1.3, 1.4, 2.0, 2.1 and 3.0.
  21.  
  22. OPTIONS
  23.        -L     Set  the output graphics language.  Valid languages
  24.               are box, epic, eepic, eepicemu, ibmgl, latex, null,
  25.               pic,  pictex, ps, pstex, pstex_t, textyl, mf (META-
  26.               FONT) and tpic.
  27.  
  28.        -m     Set the magnification at which the figure  is  ren-
  29.               dered to mag.  The default is 1.0.
  30.  
  31.        -f     Set the default font used for text objects to font.
  32.               The default is Roman; the  format  of  this  option
  33.               depends  on  the graphics language in use.  In TeX-
  34.               based languages, the font is the base of  the  name
  35.               given  in lfonts.tex, for instance "cmr" for Roman,
  36.               or "tt" for teletype.  In  PostScript,  it  is  any
  37.               font name known to the printer or interpreter.
  38.  
  39.        -s     Set  the  default  font  size  (in points) for text
  40.               objects to fsize.  The default is 11*mag, and  thus
  41.               is  scaled  by the -m option.  If there is no scal-
  42.               ing, the default font is eleven point Roman."
  43.  
  44.        -V     Print the program version number only.
  45.  
  46.        other options
  47.               The other options are specific  to  the  choice  of
  48.               graphics language, as described below.
  49.  
  50.             Release 3.1(.0) (Protocol 3.1) Jan 9, 1995          1
  51.  
  52. EPIC OPTIONS
  53.        EPIC  is  an enhancement to LaTeX picture drawing environ-
  54.        ment.  It was developed by Sunil Podar  of  Department  of
  55.        Computer Science in S.U.N.Y at Stony Brook.
  56.  
  57.        EEPIC  is  an  extension to EPIC and LaTeX picture drawing
  58.        environment which uses tpic specials as a graphics  mecha-
  59.        nism.   It  was written by Conrad Kwok of Division of Com-
  60.        puter Science at University of California, Davis.
  61.  
  62.        EEPIC-EMU is an EEPIC emulation package which does not use
  63.        tpic specials.
  64.  
  65.        -l     Use  "\thicklines"  when width of the line is wider
  66.               than lwidth.  The default is 2.
  67.  
  68.        -v     Include comments in the output file.
  69.  
  70.        -P     Generate a complete LaTeX file. In other words, the
  71.               output  file can be formatted without requiring any
  72.               changes. The additional text inserted in the begin-
  73.               ning  and  at  the end of the file is controlled by
  74.               the configuration parameter "Preamble" and "Postam-
  75.               ble".
  76.  
  77.        -S     Set  the  scale  to  which  the figure is rendered.
  78.               This option automatically  sets  the  magnification
  79.               and size to scale / 12 and scale respectively.
  80.  
  81.        -W     Enable variable line width
  82.  
  83.        -w     Disable  variable  line  width.  Only "\thicklines"
  84.               and/or "\thinlines" commands will be  generated  in
  85.               the output file.
  86.  
  87.        When  variable  line width option is enabled, "\thinlines"
  88.        command is  still  used  when  line  width  is  less  than
  89.        LineThick.  One  potential  problem  is  that the width of
  90.        "\thinlines" is 0.4pt but the resolution of  Fig  is  1/80
  91.        inch (approx. 1pt). If LineThick is set to 2, normal lines
  92.        will be drawn in 0.4pt wide lines but the next line  width
  93.        is  already 2pt. One possible solution is to set LineThick
  94.        to 1 and set the width of the those lines you want  to  be
  95.        drawn in "\thinlines"  to 0.
  96.  
  97.        Due  to  this  problem,  Variable  line  width VarWidth is
  98.        defaulted to be false.
  99.  
  100. IBM-GL OPTIONS
  101.        IBM-GL (International Business Machines Graphics Language)
  102.        is  compatible  with  HP-GL (Hewlett-Packard Graphics Lan-
  103.        guage).
  104.  
  105.             Release 3.1(.0) (Protocol 3.1) Jan 9, 1995          2
  106.  
  107.        -a     Select ISO A4 (ANSI A) paper size if the default is
  108.               ANSI A (ISO A4) paper size.
  109.  
  110.        -c     Generate instructions for an IBM 6180 Color Plotter
  111.               with (without) an  IBM  Graphics  Enhancement  Car-
  112.               tridge (IBM-GEC).
  113.  
  114.        -d     Restrict  plotting  to  a  rectangular  area of the
  115.               plotter paper which has a lower left hand corner at
  116.               (xll,yll)   and   a  upper  right  hand  corner  at
  117.               (xur,yur).  All four numbers are in inches and fol-
  118.               low -d in a comma-sparated list - xll,yll,xur,yur -
  119.               with no spaces between them.
  120.  
  121.        -f     Load text character specifications from  the  table
  122.               in  the fonts file.  The table must have 36 entries
  123.               - one for each font plus  a  default.   Each  entry
  124.               consists  of  5 numbers which specify the 1.) stan-
  125.               dard character set (0 - 4, 6 - 9,  30  -  39),  2.)
  126.               alternate  character  set  (0 - 4, 6 - 9, 30 - 39),
  127.               3.) character slant angle (degrees), 4.)  character
  128.               width  scale  factor and 5.) character height scale
  129.               factor.
  130.  
  131.        -l     Load area fill line patterns from the table in  the
  132.               patterns  file.   The  table must have 21 entries -
  133.               one for each of the area fill patterns.  Each entry
  134.               consists of 5 numbers which specify the 1.) pattern
  135.               number (-1 - 6), 2.) pattern length  (inches),  3.)
  136.               fill  type  (1  - 5), 4.) fill spacing (inches) and
  137.               5.) fill angle (degrees).
  138.  
  139.        -m     The magnification may appear as the  first  element
  140.               in  a  comma sepatated list - mag,x0,y0 - where the
  141.               second and third parameters specify  an  offset  in
  142.               inches.
  143.  
  144.        -p     Load  plotter  pen specifications from the table in
  145.               the pens file.  The table must have 9 entries - one
  146.               for each color plus a default.  Each entry consists
  147.               of 2 numbers which specify the 1.) pen number (1  -
  148.               8) and 2.) pen thickness (millimeters).
  149.  
  150.        -P     Rotate  the figure to portrait mode. The default is
  151.               landscape mode.
  152.  
  153.        -S     Set the pen speed to speed (centimeters/second).
  154.  
  155.        -v     Plot the figure upside-down  in  portrait  mode  or
  156.               backwards  in  landscape  mode.  This allows you to
  157.               write on the top surface of overhead transparencies
  158.               without  disturbing  the  plotter ink on the bottom
  159.               surface.
  160.  
  161.             Release 3.1(.0) (Protocol 3.1) Jan 9, 1995          3
  162.  
  163.        Fig2dev may be installed with either  ANSI  A  or  ISO  A4
  164.        default  paper  size.  The -a option selects the alternate
  165.        paper size.  Fig2dev does not fill  closed  splines.   The
  166.        IBM-GEC  is  required to fill other polygons.  Fig2dev may
  167.        be installed for plotters with  or  without  the  IBM-GEC.
  168.        The -c option selects the alternate instruction set.
  169.  
  170. LATEX OPTIONS
  171.        -l     Sets  the  threshold  between  LaTeX thin and thick
  172.               lines to lwidth pixels.  LaTeX  supports  only  two
  173.               different  line  width: \thinlines and \thicklines.
  174.               Lines of width greater than lwidth pixels are drawn
  175.               as  \thicklines.   Also affects the size of dots in
  176.               dotted line style.  The default is 1.
  177.  
  178.        -d     Set a separate magnification for the length of line
  179.               dashes to dmag.
  180.  
  181.        -v     Verbose mode.
  182.  
  183.        LaTeX cannot accurately represent all the graphics objects
  184.        which can be described by Fig.  For example, the  possible
  185.        slopes  which  lines  may have are limited.  Some objects,
  186.        such as spline curves, cannot be drawn at all.   Fig2latex
  187.        chooses  the closest possible line slope, and prints error
  188.        messages when objects cannot be drawn accurately
  189.  
  190. PIC OPTIONS
  191.        -p     Enables the use of certain PIC extensions which are
  192.               known to work with the groff package; compatibility
  193.               with DWB PIC is unknown.  The extensions enabled by
  194.               each option are:
  195.  
  196.        arc    Allow ARC_BOX i.e. use rounded corners
  197.  
  198.        line   Use the 'line_thickness' value
  199.  
  200.        fill   Allow ellipses to be filled
  201.  
  202.        all    Use all of the above
  203.  
  204.        psfont Don't convert Postscript fonts generic type (useful
  205.               for files going to be Ditroff'ed for and printed on
  206.               PS printer). DWB-compatible.
  207.  
  208.        allps  Use all of the above (i.e. "all" + "psfont")
  209.  
  210. PICTEX OUTPUT
  211.        In order to include PiCTeX pictures into a document, it is
  212.        necessary to load the PiCTeX macros.
  213.  
  214.             Release 3.1(.0) (Protocol 3.1) Jan 9, 1995          4
  215.  
  216.        PiCTeX uses TeX integer register  arithmetic  to  generate
  217.        curves,  and  so  it is very slow.  PiCTeX draws curves by
  218.        \put-ing the psymbol repeatedly, and so requires  a  large
  219.        amount  of  TeX's internal memory, and generates large DVI
  220.        files.  The size of TeX's memory limits the number of plot
  221.        symbols  in  a  picture.   As  a result, it is best to use
  222.        PiCTeX to generate small pictures.
  223.  
  224. POSTSCRIPT OPTIONS
  225.        With PostScript, Fig can be used to create large  posters.
  226.        The  figure  will  be  created  by printing multiple pages
  227.        which can be glued together.  Simply by not specifying the
  228.        -c  (centering) option and by specifying the -P (add show-
  229.        page) option you will get a  multi-page  output.   Due  to
  230.        memory  limitations  of  most  laser  printers, the figure
  231.        should not be too complicated. Great for  text  with  very
  232.        big letters.
  233.  
  234.        Text  can  now  include  various ISO-character codes above
  235.        0x7f, which is useful for language specific characters  to
  236.        be  printed  directly.   Not all ISO-characters are imple-
  237.        mented.
  238.  
  239.        Color support: Colored  objects  created  by  Fig  can  be
  240.        printed  on a color postscript printer. There are 32 stan-
  241.        dard colors: black, yellow, white, gold,  five  shades  of
  242.        blue,  four  shades  of  green,  four shades of cyan, four
  243.        shades of red, five shades  of  magenta,  four  shades  of
  244.        brown,  and four shades of pink.  In addition there may be
  245.        user-defined colors in the file.  See the  xfig  FORMAT3.1
  246.        file  for the definition of these colors.  On a monochrome
  247.        printer, colored objects will  be  mapped  into  different
  248.        grayscales  by  the  printer.   Filled objects are printed
  249.        using the  given  area  fill  and  color.   There  are  21
  250.        "shades"  going  from black to full saturation of the fill
  251.        color, and 21 more "tints" from full  saturation  +  1  to
  252.        white.  In addition, there are 16 patterns such as bricks,
  253.        diagonal lines, crosshatch, etc.
  254.  
  255.        -c     option centers the figure on the page.  The center-
  256.               ing  may  not be accurate if there are texts in the
  257.               fig_file that extends too far to the right of other
  258.               objects.
  259.  
  260.        -l dummy_arg
  261.               Generate figure in landscape mode.  The dummy argu-
  262.               ment is ignored, but must  appear  on  the  command
  263.               line  for  reasons  of  compatibility.  This option
  264.               will override the orientation specification in  the
  265.               file (for file versions 3.0 and higher).
  266.  
  267.        -M     Generate  multiple  pages  if  figure  exceeds page
  268.               size.
  269.  
  270.             Release 3.1(.0) (Protocol 3.1) Jan 9, 1995          5
  271.  
  272.        -p dummy_arg
  273.               Generate figure in portrait mode.  The dummy  argu-
  274.               ment  is  ignored,  but  must appear on the command
  275.               line for reasons  of  compatibility.   This  option
  276.               will  override the orientation specification in the
  277.               file (for file versions 3.0 and higher).   This  is
  278.               the  default for Fig files of version 2.1 or lower.
  279.  
  280.        -P     indicates that the figure  describes  a  full  page
  281.               which will not necessarily be inserted into a docu-
  282.               ment, but can be sent directly  to  a  PS  printer.
  283.               This ensures that a showpage command is inserted at
  284.               the end of the figure, and inhibits translation  of
  285.               the figure coordinate system.
  286.  
  287.        -n name
  288.               Set  the  Title  part  of  the PostScript output to
  289.               name.  This is useful when  the  input  to  fig2dev
  290.               comes from standard input.
  291.  
  292.        -x offset
  293.               shift the figure in the X direction by offset units
  294.               (1/72 inch).  A negative value shifts the figure to
  295.               the left and a positive value to the right.
  296.  
  297.        -y offset
  298.               shift the figure in the Y direction by offset units
  299.               (1/72 inch).  A negative value shifts the figure up
  300.               and a positive value down.
  301.  
  302.        -z pagesize
  303.               Sets  the  pagesize. Available page sizes are "Let-
  304.               ter" (8.5" x 11"), "Legal"  (11"  x  14")  "Ledger"
  305.               (11" x 17"), "A4" (21cm x 29.7cm), and "B5" (18.2cm
  306.               x 25.7cm).
  307.  
  308. PSTEX OPTIONS
  309.        The    pstex language is a variant of ps which  suppresses
  310.               formatted (special) text.  The pstex_t language has
  311.               the complementary behavior: it generates only LaTeX
  312.               commands necessary to position special text, and to
  313.               overlay the PostScript file generated using  pstex.
  314.               These  two drivers can be used to generate a figure
  315.               which combines the flexibility of PostScript graph-
  316.               ics with LaTeX text formatting of special text.
  317.  
  318.        The    pstex_t  option  -p  file specifies the name of the
  319.               PostScript file to be overlaid.  If not set or  its
  320.               value is null then no PS file will be inserted.
  321.  
  322.             Release 3.1(.0) (Protocol 3.1) Jan 9, 1995          6
  323.  
  324. TEXTYL OPTIONS
  325.        There are no TeXtyl-specific options.
  326.  
  327. METAFONT OPTIONS
  328.        -C code
  329.               specifies the starting METAFONT font code.
  330.  
  331.        -n name
  332.               specifies the name to use in the output file.
  333.  
  334.        -p pen specifies the size of the METAFONT pen.
  335.  
  336.        -t top specifies the top of the whole coordinate system.
  337.  
  338.        -x xneg
  339.               specifies  the  minimum  x  coordinate value of the
  340.               figure (inches).
  341.  
  342.        -y yneg
  343.               specifies the minumum y  coordinate  value  of  the
  344.               figure (inches).
  345.  
  346.        -X xpos
  347.               specifies  the  maximum  x  coordinate value of the
  348.               figure (inches).
  349.  
  350.        -Y ypos
  351.               specifies the maximum y  coordinate  value  of  the
  352.               figure (inches).
  353.  
  354. TPIC OPTIONS
  355.        There are no tpic-specific options.
  356.  
  357. SEE ALSO
  358.        [x]fig(1), pic(1) pic2fig(1), transfig(1)
  359.  
  360. COPYRIGHT
  361.        Copyright (c) 1985 Supoj Sutantavibul
  362.        Copyright (c) 1991 Micah Beck
  363.  
  364.        Permission to use, copy, modify, distribute, and sell this
  365.        software and its documentation for any purpose  is  hereby
  366.        granted  without  fee,  provided  that the above copyright
  367.        notice appear in all copies and that both  that  copyright
  368.        notice  and  this  permission  notice appear in supporting
  369.        documentation. The authors make no  representations  about
  370.        the  suitability  of this software for any purpose.  It is
  371.        provided "as is" without express or implied warranty.
  372.  
  373.        THE AUTHORS DISCLAIM ALL WARRANTIES WITH  REGARD  TO  THIS
  374.  
  375.             Release 3.1(.0) (Protocol 3.1) Jan 9, 1995          7
  376.  
  377.        SOFTWARE,   INCLUDING   ALL  IMPLIED  WARRANTIES  OF  MER-
  378.        CHANTABILITY AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE
  379.        LIABLE  FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES
  380.        OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA
  381.        OR  PROFITS,  WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  382.        OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN  CONNECTION
  383.        WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  384.  
  385. AUTHORS
  386.        Micah Beck
  387.        Cornell University
  388.        Sept 28 1990
  389.  
  390.        and Frank Schmuck (then of Cornell University)
  391.        and Conrad Kwok (then of U.C. Davis).
  392.  
  393.        drivers contributed by
  394.        Jose Alberto Fernandez R. (U. of Maryland)
  395.        and Gary Beihl (MCC)
  396.  
  397.        Color  support,  ISO-character encoding and poster support
  398.        by
  399.        Herbert Bauer (heb@regent.e-technik.tu-muenchen.de)
  400.  
  401.        Modified from f2p (fig to PIC), by the author of Fig
  402.        Supoj Sutanthavibul (supoj@sally.utexas.edu)
  403.        University of Texas at Austin.
  404.  
  405.        MetaFont driver by
  406.        Anthony Starks (ajs@merck.com)
  407.  
  408.             Release 3.1(.0) (Protocol 3.1) Jan 9, 1995          8
  409.  
  410.